home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / rtmon-run.z / rtmon-run
Text File  |  1998-10-20  |  4KB  |  67 lines
  1.  
  2.  
  3.  
  4. RRRRTTTTMMMMOOOONNNN----RRRRUUUUNNNN((((1111))))                                                      RRRRTTTTMMMMOOOONNNN----RRRRUUUUNNNN((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      rrrrttttmmmmoooonnnn----rrrruuuunnnn - enable system call event tracing
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      rtmon-run ----cccc _c_o_o_k_i_e [ ----iiii ] [ ----pppp _p_i_d ] [ ----tttt _s_e_c_s ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      rrrrttttmmmmoooonnnn----rrrruuuunnnn is used in conjuction with rrrrttttmmmmoooonnnn----cccclllliiiieeeennnntttt(1) to collect system
  16.      call events from a remote machine.  rrrrttttmmmmoooonnnn----rrrruuuunnnn marks one or more processes
  17.      for system call event tracing and then pauses waiting for an interrupt or
  18.      a time limit to expire.  If no processes are specified on the command
  19.      line, the entire system is monitored.  Event collection must be done
  20.      separately; typically from another machine with the rrrrttttmmmmoooonnnn----cccclllliiiieeeennnntttt
  21.      application.  rrrrttttmmmmoooonnnn----rrrruuuunnnn must be run on the machine where the processes to
  22.      be traced are located because it must access the ////ddddeeeevvvv////ppppaaaarrrr special file to
  23.      enable system call tracing for the processes.  rrrrttttmmmmoooonnnn----rrrruuuunnnn is normally not
  24.      needed; the ppppaaaarrrr(1) and ppppaaaaddddcccc(1) programs are the preferred means for
  25.      collecting system call event traces.  The only reason to use rrrrttttmmmmoooonnnn----rrrruuuunnnn
  26.      instead of ppppaaaaddddcccc is to avoid any overhead associated with running ppppaaaaddddcccc on
  27.      the system where data is to be collected.
  28.  
  29. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  30.      ----cccc _c_o_o_k_i_e
  31.           Use _c_o_o_k_i_e when enabling system call tracing for the specified
  32.           processes.  A cookie is a magic number that is used by rrrrttttmmmmoooonnnndddd(1) to
  33.           determine which client programs may receive system call event data.
  34.           The cookie to pass to rrrrttttmmmmoooonnnn----rrrruuuunnnn is obtained by specifying the ----vvvv
  35.           option when starting rrrrttttmmmmoooonnnn----cccclllliiiieeeennnntttt(1).  The rrrrttttmmmmoooonnnn----cccclllliiiieeeennnntttt program must
  36.           be started before running rrrrttttmmmmoooonnnn----rrrruuuunnnn in order to obtain a valid
  37.           cookie to supply as a parameter to the ----cccc option.
  38.  
  39.      ----iiii   Inherit system call event tracing to future children of the
  40.           specified processes.
  41.  
  42.      ----pppp _p_i_d
  43.           Enable system call tracing for the process _p_i_d.  This option may be
  44.           used multiple times to enable tracing of multiple processes.
  45.           Processes specified with this option must belong to the current user
  46.           unless the user has super-user privilege.
  47.  
  48.      ----tttt _s_e_c_s
  49.           Collect tracing information for _s_e_c_s seconds before terminating.  If
  50.           this option is not specified then rrrrttttmmmmoooonnnn----rrrruuuunnnn will pause until it is
  51.           interrupted from the keyboard or by receiving a signal.
  52.  
  53. FFFFIIIILLLLEEEESSSS
  54.      _////_dddd_eeee_vvvv_////_pppp_aaaa_rrrr    for enabling system event tracing
  55.  
  56. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  57.      _pppp_aaaa_rrrr(1), _pppp_aaaa_dddd_cccc(1), _rrrr_tttt_mmmm_oooo_nnnn_----_cccc_llll_iiii_eeee_nnnn_tttt(1), _rrrr_tttt_mmmm_oooo_nnnn_dddd(1), _pppp_aaaa_rrrr(7).
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.